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ABSTBACT 

This paper focuses on two aajor issues in the third 
stage of the iapleaentation and disseaination process for coaputer 
based instruction (CBI)—copyright and docuaentation. The purpose, 
special probleas,* and different approaches or aethcda of copywriting 
and docunenting CBI naterials are discussed. Tables cutlite the types 
of inforaation required for the docuaentaticn of Level I, which 
catalogues or identifies courseware, and level II, which provides the 
types of inforaation required by^lndividuals who actually icrk with 
the courseware. The iapcrtance of accepting copyright and 
docuaentation as integral conponents of CEI activity is ciphasized. 
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This papar surveys /two topics of importance in the 
implementation . and disseaination of CBI! copyright and 
documentation* The discussion covers the purpose of 
copyright and' documentation* special problems ' in 
copyrighting and documenting CBI materlals» and different 
approaches or methods In the copyright and documentation of 
CBI. The importance of accepting copyright and documentation 
as integral components jof CBI* activity is emphasized. 
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Theta are three eajer stages or phases that a CBI 
project progresses through. Stage I (infancy) involves the- 
initial planning and organization of the project* acquiring 
hardware* developing or obtaining courseware* scheduling* 
and assigning responsibilities* Much of the effort in stage 
I is devoted to equipment problems and political squabbles* 
Stage II (adolesence) is mainly concerned with 
implementation details* the debugging* modification* and 
evaluation ' of courseware* achieving 
reliability* ‘and 'taking stock of the 
limitations of the system* 'Stage III 
production ,phase were courseware has achieved a "completed" 
or optimized status and the focus turns to the ^tiseemination 
of the courseware.and knowledge gained in the development of 
the project* In stage III* topics such as networks* 
copyright* documentation* and evaluation become proqinentp 
Bach of these three stages produces a different CBI 
environment and will involve different capabilities and 
talents on the part of the project members* Just as the 
infancy - adolescence - maturity metaphor suggests* there is 
a gradual transition from one stage to another and a project 
can revert back to previous stages at times* 


and maintaining 
capabilities and 
(maturity) is a 


This paper focuses on /two topics which arise in Stage 
III: copyright and documentation* They are distinct issues* 
yet closely related to the general problem*of dissemination 
of CBI materials* However* it is a mistake to think that 
these two topics are of no interest to CBI projects which 
are at stage I or II* As I hope will/ become evident in the 
following discussion* copyright ai»d documentation problems 
become headaches because they wsren* t considered early 
enough in a CBI project* 

Cgnygjgfat and CBI 

/ 

Copyright is essentially a means of protecting creative 
effort (and any financial benefits to be derived from this 
effort)* It allows the public use/of an intellectual product 
while still preserving the private ownership rights of the, 
individual• While’ Intellectual products are most typically 
thought of as literary works* copyright also covers dramatic 
and musical productions* paintings* photographs* films* 
sculptures* records* and any type of broadcasting* Copyright 
ie established simply by affixing a copyright notice to any 
work when it first becomes fUiblically used* It is not 
necessary to register a copyright with the Copyright Office 
to establish copyright protection* although this is a 
prudent move in the eveht of J subsequent infringement* 




The question of whether copyright laws also apply to 
computer prograss is a difficult one* It is generally 
accepted that the writing of a computer prograa constitutes 
a creative act and hence the program- is an intellectual 
product worthy of copyright protection* However* a problem 
*fiM* over the. question of whether* a computer merely 
reproduces 'the programs (as one reproduces a book* play* 
record* etc*) or whether the fact that the program 
transforms* selects* compiles* or controls a machine (i*e** 
its effects are intangible) makes a prograa different from 
all other intellectual products* While there is some 
-consensus that the new U*S* Copyright Act is broad enough to 
protect computer programs without special provisions* -it 
will t remain unsettled until test cases establish a 
precedent* A comprehensive discussion of the issues involved 
is provided by Mooers (1975)* 

As if the application of copyright law to computer 
eoftware wasn't problematic enough* the application to GBI 
materials poses further problems* Pirstly* copyright laws 
usually have educational exceptions — waivers' of copyright 
infringement if the material is to be used in the course of 
instruction- or private study* Secondly, r CBI materials often 
involve a number of different media (e«g.* audio*' film* 
video* printed materials* etc* )* each . of which nay have 
different copyright coverage* Thirdly* CBI -courseware is 
often "consumed" in a non—tangible form* namely by viewing 
it on a cathode or plasma display screenV Only if copyright 
covers the actual execution of th^ 1 program (.as the* 
performance of a play), will it provide protection* Pinally* 
CBI courseware is dynamic and usually under a constant state 
of modification and revision* According to copyright law* 
every modification* no matter how minor* should be 
authorized by the copyright owner* 


Given the problematic nature of copyrighting CBI 
materials* one might expect that little material has been 
copyrighted..In terms of sheer bulk* this is probably true* 
However* a number of successful CBI materials have been 
copyrighted, although different approaches have been 
followed* It will be worthwhile to consider briefly examples 
which illustrate different copyright arrangements* 

In the traditional approach to copyright agreements, 
.ownership and royAlties belong to the author(s) of the 
material* This, is .exemplified by the arrangement made by 
W.F. Pillsbury (Inox College* Illinois) with South-Western 
Publishing Company for the marketing of his very successful 
computer-based accounting course* The copyright actually 
covered the student handbook and teaching guide while the 
prograa was provided at no cost* This agreement follows the 
usual*approach of the publishing.Industry* ' 


The 


copyright arrangement 


on the Huntington project 
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■^•riala ms bs«*ssa NSF (who fu^ndsd the project) and DEC* 
Royalti.ee fro« the sale of the prograss are paid to the 
State of New York &nd then funnelled back to the Huntington 
Project for further development work. In this arrangement, 
the ownerehip reeldee with the funding organization . ( NSP) 
and a computer company (DEC). -The copyright ^arrangement of 
the REDACT project materials which fcers developed by NRBL 
(Northwest Regional Education Lab) under the support of th« 
Office of Education in similar. HoweVer. with the REACT 
materialSf the royalties are shared by NREL and the Office 
of Education. 

‘ Probably the most important CBI copyright agreement 
which presently exists is the one between the University of 
Illinois and CDC for PLATO. The agreement is quite 
comprehensive . hnd establishes different classes of 
authorship and institutional participation which determines 
different percentages of royalty rates, release rights, and 
error correction responsibilities. For example, 

noncommissioned authors ( students or employees of the 
university) have the sole right to designate whether 
courseware is ready for distribution, receive 75* of the 

gross royalties, and are responsible for the correction of 
errors. In the case of commissioned authors, however, the 
university reserves^ the right to decide whether the 

courseware is ready for release. the responsibility for 

error correction and the commissioned author recieves 40* of 
the gross royalties. Royalty rates for courseware are 

specified in terms of student contact hours according to 
instructional level and percentage of sales for ancillary 
("non-co«puterl materials. An important aspect of the PLATO 
agreement is that the ownership of all courseware is vested 
with the University of Illinois on behalf of authors. Thus 
the individual ownership rights are mediated .by an 
educational institution. " 

f • 

These examples' illustrate different approaches to the 
copyright of CBI materials. Two emerging technologies., 
mlhrjJ&omputers and videodiscs. are likely to have sajor 
effects on the copyright situation in CBI. Both* of these 
technologies will- allow the mass duplication of CBI 
materials while insuring that the original copy is difficult 
to produce and modify. Thi's is essentially the same 
situation as books, records, films, etc. Microcomputers and 
videodiscs will also provide an inexpensive delivery medium 
operating under commercial incentives aqd constraints rfther 
than an educational (non-profit) environment. 

I 

, * S 

As CBI becomes a 'major cpmponent of mainstream 

education (as we all believe it will), copyright procedures 
must become an integral and automatic part of CBI. This 
means that courseware usage must be accurately logged .and 
reported so tha^t royalties can be.computed. It also means'^ 
thW-t all - CBI projects (whether at universities., school 
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systems* oK Industry,) suit develop ths 'appropriate 
administrative 'procedures for tha payment of royalties* We 
auet bb prepared for the «ria realities of copyright — 
infringements and legal actions* t 

ggcuasatfttiflD la cbi 

The docuaentation "of coaputer software is a formal 
aeans of coaaunica'ting inforaation aboui the use ,and nature 
of prograaS*. Without adequate docuaentation* inforaation 
about the appropriate use and aaintenance of prograas < tends 
to be haphazard* Ultimately this results in the inefficient 
operation of boaputer systems 'and econoaic loss* It is not 
surprising therefore* that considerable effort has been 
devoted.to aethods^and procedures for software documentation 
in business and industry* 

M 

,In the reala of coaputer^based education* Interest in 
docuaentation could- be. described as aneaic* This is rather 
unfortunate since docuaentation is absolutely critical to 
the field of CpI. Development of courseware is an expensive 
V and tiae consuming activity* This effort can only be 
Justified if the courseware,can be shared by aany students 
at different institutions* If such a transfer of material is 
to be accomplished successfully* documentation is essential* 
Docuaentation is also necessary to prevent the duplication 
of similar or identical courseware either between or within 
the same institutions* Just think of how aany duplicate sets 
of arithaetic drill and practice prograas or basically 
identical introductory statistics programs exist* Finally* 
documentation of courseware usage is needed in order to 
monitor student progress and also to evaluate "the* 
instructional effectiveness of courseware* 

Most of the -ideas which apply to the documentation of 
computer software in general also apply to the documentation 
of CBE courseware* and Saterials* However* there are a number 
of iaportant differences* One major difference is that 
rather than having a single category of user* there aay be 
two or three types , of users of a CBI prograa (student* 
instructor* proctor) each of whoa will require different 
types of documentation* Another difference is that 
instructional softwags is auch aore concerned with 
monitoring user behavior and keeping detailed records than 
rion-instructional software* Instructional programs often 
involve considerable use of graphic displays*, special 
character sets* -and mixed input grades as well as the 
syncronization with coaputer-controlled audio* film or video 
devices* Finally* instructional strategies and logics 
involved in the individualization 1 of instruction require 
description which extends beyond 'that of the usual 
algorithas or aethods embodied in non~instructional 
programs* In short* CBI prograas pose aany additional 
pro|>leas for the documentation of coaputer software* 
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The two aajor probUas to bo faced in the docuaentation 
of CBB aoftware are (1) ia to be docuaentedf and (2) 

tX9JL i« thia documentation to be produced* Consideration of 
the firat queatlon auggesta the need for two aajor leweia of 
docuaentation* Level X docuaentation ia general and conciae 
and deaignad chiefly to catalogue or identify CBI 
couraeware* It*a aain purpoae ia to provide an interaated 
user with enough inforaation to decide whether a prograa is 
worth further investigation* Table 1 Indicates the type of 
inforaation whiclh Level I docuaentation should contain* Thia 
type of docuaentation ia exemplified’ by the In^ew to 
Caanttfag Baaed Instruction which is compiled and distributed 
by-the Instructional Media Laboratory at the University of 
Wisconsin—Milwaukee or the ‘docuaentation of the Minnesota 
Educational Coaputer Consortium ( see Koch* 1977)* ' Level I 
docuaentation is brief and relatively inexpensive to produce 
and distribute* It is also independent of the size and | 
coaplexity of the courseware* ^ 

. . , | 

Level II docuaentation* however* will depend upon the 

size* nature* and coaplexity of the aaterials* It is 'j 
intended to,proVida the detailed Inforaation required by the 
individuals who actually work with the courseware* Thinir 
includes five different types of users: instructors* || 
proctors (i*e** teaching ^assistants )* coaputer operators*ip, 
prograaaers* add students* The distinction between the first fj 
four categories will depend upon the olze. and nature of the 
project* Thus* in a large CBI project ' such as PLATO* the^ 
Instructor (author)* proctor* coaputer operator and! 
prograaaer will be different people*^ On the hand* in 
school context* teachers are likely to design* write* and 
use the prograa theaselves* In the case of a aini or 
aicrocoaputer* one person aay be all of these plus coaputqr 
operator too* However* these five functions are distinct ai)d 
necessary coaponents whether they are fulfilled by separate 
or different individuals and hence docuaentation for each 
required* Table 2‘ provides a set of suggelrtlons about tjhA 
inforaation needed by each of the five types of users* 


Having specified what needs to be documented* the 
problem remains of how to actually produe e the 
documentation* There are three aajor approaches: manual 
docuaentation* self-documenting author systems* and post—hoc 
docuaentation produced froa the code* Manual documentation 
involves developing adainlstrative procedures or assigning 
task responsibilities to ensure that the docuae'ntatlop is 
produced* SeIf—documenting author systeas require that a 
description be provided every time a variable is Assigned* a - 
loop initiated* a switch/counter used* ptc* These 
descriptions bbcose coaaents in the actual code* It has the 
added advantage that it allows the system to. detect 
potential errors while the course is be4ng developed* e*g«* 
non-terainating loops* unassigned or dimensioned variables* 
missing branch locations and so ; on* The third approach* , 
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post-hoc documentation* involves dovaloping prograas which 
produce documentation from the code in terms of mapping out 
instructional strategies or logics* identifying variables* 
loops* counters/switches used* or providing cross' 
referencing* 

Most CBJ systems provide tor ' the automatic 
documentation of student activity. Ideally this will include 
both records of individual student progress as well as a 
summary of group performance for particular instructional 
sequences or units. The 'former information ip needed tof 
evaluate the student; the latter to evaluate the 
instructional design. The need for the automatic 
documentation of System and courseware usage has already 
been mentioned in conjunction with copyright. • This 
information also can also serve to document system 
reliability as well. 

Where possible* the latter two documentation approaches 
are to be preferred over the first since automatic methods 
guarantee that a pre»specified standard of documentation Js 
obtained. Furthermore* this will provide documentation of 
the program as it actually is* not as it was originally 
Intended to be. Automatic documentation is intended to be 
helpful in overcoming the grim realities of documentation: 
sloppiness* laziness* and caprice. 

Canslualaa 

It should be clear that copyright and documentation are 
important components .in the development and implementation 
of CBI materials. Both copyright and documentation affect 
the dissemination* quality* and economics of CBI* and hence 
the eventual success of CBI as an educational methodology. 
Copyright and documentation must • be accepted as integral 
aspects of a CBI project at the outset. The time to 
establish ownership and royalty arrangements* to develop 
system monitoring of usage* and to setup administrative 
channels for royalty payment is not after the courseware is 
developed but before it starts. Agreement on what should be 
documented and the procedures ( sanual or automatic. for 
producing /this documentation must be established before 
programming begins so that documentation is available as 
soon as needed. Indeed* copyright and documentation may be 
prim realities but they are much less of a chore if faced 
earlier than later. 
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6 . 

7 . 


8 . 

9 . 

10 . 
1 1 . 

12 . 

13 . 

14 . 

15. 

16 . 
1 7 . 


Table 1. 

Level I Documentation 

subject matter of the course 
description of content (very brief, 
status of the course (development/operational. 
author! s* of the course (person responsible for the 
definition of subject matter .and instructional 
strategies* 

exact address of author or person to contact for further 
information 

i-®6i Hty and conditions for release of courseware 
characteristics of Intended student group (preferably 
wentionIng appropriate pre-entry skills or grade 
levels. 

types of instructional ■strategies / logics used 
amount of time required to complete course (average and 
.range. 

support materials required (student handouts, 
textbooks* or special equipment, 
support media (type of audio* film, video* 

» which are needed by the program/system., 
the programming language 

the system used (cpu and operating system, 
the typq^of terminal's used 
applications (extent to. vhifch 
for formal instruction. 
published ^ references (Including any evaluation 
• information. 

date of this documentation 


manuals* 

graphics* 


the course has been used 


* 


f 





f 


10 


267 


% * « 

Table 2. 

Level II Documentation ' 

r 


Aa Inalrustar . 

1. Mjor «duettlon«l objietivtt of «ho count 
2* pr,»-«ntry skills rtqul^rtd fop ooeh objtellvt 

3* for each definable Inrtructieoal unit within tbo program* • ' dttcrlptloa 
of* ' 

I) tubjoct oof-tor content * 

II) 1 notrue*1anal strategies used 

III) media support roqulrod (tudlo f workbooks* ste) 
lv) tTtrigo tloo for completion 

4* ovollobllltjr tnd ntturo -of porforoaneo roeortfo utod-to Monitor atudtat 

progroto 

So eoaploto oeroon bp tcrotn dliplajr of progrtu 
So availability and aourca of evaluation raaul ta/otudlaa 
)• degree of Instructor iatarvantloa/taaiataaca raqulrad 
So dlaclalaaro and restrictions on uss and modification of pragma 

Bt. Erne tor i;ocuaaB?ttio B 


1* nssd for and moaning of any studsnt registration praesdursa and paaaaorda 
2o a dsscriptlon, parhapa by flowchart* shooing tbs sntry, points in ths 
course* ths ssqusncs of instructional units* and ths variations of 
asqusnes possible duo to Individualixatlon or branching 
So ths nssd for and location of proctor intorvantian* including a list of 
■••sagos and appropriate action to bo taken 
4* a complsts lint of all questions asksd In ths program and corrset and 
Incorrect answers 

5* a description of 'procedures for allowing a student to bypass or review a 
unit in the course 

6o the location within the course oK all examinations 
7« procedures for handling cheating or ayatem failures during exams 


CLa. Oners tar Documentation 

4 

1* the nature and location of the course code (source* object* etc* ) 

2m the operating details of the hardware involved (e*g), epu* discs* 'tapes* 
terminals* printers) 

3* the details of the operating syeteo and all oystem software (including 
startup* backup* and emergency procedures) 

4* parameter* affecting the computer resources needed fpr each program ( 
memory, graphics* character fonts* etc* ) 

5« recovery procedures for syeteo failures (hardware or soffears) 


fia Etugrms—C Pocumcntat Ion _ 

✓ 

1* avallablIty of source code listings for each course 

2m the names ahd locations of all functions* macros* variables* labels, etc), 
within the course 

3« the particular programing strategies/logic used to produce certain 
instructional displays or effects 

4* a complete listing of all error messages which sight occur* their loaning 
■ and corrective action 


Ea Student Dflsustnta.ilan 


1. 

2. 

3. 

4. 

5. 


course outline giving organization of course . 

description of how to use system and terminals 

description of any scheduling arrangements (when the system lo available 
for that course*) 

how to communicate to the author/i.not ruetor via the system (If possible*) 
bow to use any special system features^(e*g*« calculation mode* learner 
control keys* etc)* 
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